Gemplus Twin Serial Smart card reader drivers disk for Windows 98, 98SE and ME.
GTwinSer.sys Version 1.0.4.1, March 2003.
Grloader.vxd Version 1.0.0.6, March 2003.
Grbus.sys    Version 1.0.1.7, July  2003.

Caution:
--------
This readme file is specifically written for the above-mentioned 
driver version. Before proceeding, you might want to check whether a
later driver version is available from www.gemplus.com

Contents:
---------

   1. Release notes
   2. Pre-Requisites
   3. Disk Content
   4. Smart Card Interface driver use
      4.1. Driver installation
      4.2. Driver update
      4.3. Driver removal
      4.4 Add More serial smartcard reader
      4.5 Change Communication baudrate
   5. User notes (Known deviations)
   6. Troubleshooting
   7. Support


1. Release notes
----------------
GTwinSer.sys Version 1.0.4.1, March 2003.
   This is the initial driver version certified by Microsoft.
   It is specifically designed for the 
   GTwinSER Serial Smart card reader, 
   Pnp id: Serenum\GEM3417 with Gemcore Twin Pro chip set.
Grloader.vxd Version 1.0.0.6, March 2003.
Grbus.sys    Version 1.0.1.7, July  2003.




2. Pre-Requisites
-----------------

To be usable, this installation requires that the Microsoft Win32
Smart Card Base Components Version 1.0 be previously installed.

To check the Microsoft Win32 Smart Card Base Components installation,
   Go to the Control Panel (Choosing "Settings" in the Start menu,
   then "Control Panel")
   Start the "Add/Remove Programs" applet
   Check that "Microsoft Smart Card Base Components" is listed in the
   programs displayed in the scroll box.

You also need to have the Smclib common libraries installed on your
computer.

To check this installation,
   Go in %WINDIR%\system\ and
   Check that smclib.vxd file is present.
   Right-click on this file and select "Properties",
   Select "Version" tab,
   Select "Product Version" and verify that you have at least 4.00.951
and / or
   Go in %WINDIR%\system32\drivers\ and
   Check that smclib.sys file is present.
   Right-click on this file and select "Properties",
   Select "Version" tab,
   Select "Product Version" and verify that is set to 5.00.

If any of the above components (Smclib or Smart Card Base Components)
is not installed on your system, please contact technical support
(see below).

The files include in the Smart Card Base Components Version 1.0 are:
   %WINDIR%\system\scardsvr.exe
   %WINDIR%\system\scarddat.dll
   %WINDIR%\system\scarddlg.dll
   %WINDIR%\system\scardmgr.dll
   %WINDIR%\system\scardsrv.dll
   %WINDIR%\system\scntvssp.dll
   %WINDIR%\system\winscard.dll
   %WINDIR%\system\smclib.vxd
   %WINDIR%\system32\drivers\smclib.sys


3. Disk Content
---------------

The following components are included with this Disk:
   - Readme.txt   	  Ver 1.0
     This file.		
   - GTwinSER.Sys	  Ver 1.0.4.1
     PC/SC driver for Gemplus Serial Smart Card Interface
   - GTwinSER.inf	  Ver 1.0.4.1
     Installation file for Microsoft Wizard
   - GTwinSER.Cat	
     Signature File from MS Windows Hardware Quality Labs
   - GrBus.inf		  Ver 1.0.1.7
     Installation file for Gemplus Virtual Bus.
   - GrBus.sys            Ver 1.0.1.7
     Gemplus Virtual Bus for serial reader.
   - GrLoader.inf	  Ver 1.0.0.6
     Installation file for Gemplus Readers loader.
   - GrLoader.Vxd         Ver 1.0.0.6
     Gemplus Readers loader for serial Pnp reader.


4. Smart Card Interface driver use
----------------------------------

   4.1. Driver installation

      Do not plug reader first before performing installation.
      We suggest to use the setup program to install all drivers components properly.


	ELSE

      Here is the description for installation by user.
	
      4.1.1. Installation of Virtual Bus readers driver.

	1. Launch the Add New Hardware wizard from Control Panel.
	   Press the Next button twice to dismiss the first two pages.

	2. If you see a dialog listing Plug and Play devices that arent
           working correctly, select the choice that reads,
           "No, the device isn't in the list" and press the Next button. 

	3. If you see a dialog asking your permission to search for hardware
           that isnt Plug and Play compatible, select the choice that reads,
           "No, I want to select the hardware from a list" and press the Next button. 

	4. Youll now see a dialog that asks you to 
           "Select the type of hardware you want to install."
            Select the "Other devices " choice and press the Next button. 

	5. Youll now see a dialog that lists all the sample devices youve
           previously installed. If youre installing a sample for the first time,
           press the "Have Disk" button. In the ensuing dialog, enter the directory
           where the drivers INF file is located.

	6. After selecting the appropriate directory, the Gemplus Bus Driver will be
           listed in the Models list box. Choose the Gemplus Bus Driver.
           Select this choice and press Next button.

	7. In the final dialog, press the Finish button. 
           The wizard will now copy files to perform the installation. 



      4.1.2. Installation Smartcard reader and Loader.

	1. Now, You can safely plug Reader and press Refresh in device manager.

	2.  An "Add New Hardware Wizard" dialog box show,
	    With found "Serial SmartCard reader", Press <Next>.

	3. Select "Search for the best driver for your device
	   (recommended)" and Press <Next>.

	4. Check the box "Specify a location" and Press <Browse>.

	5. Browse to the driver file location (where you find this
	   ReadMe.txt file) and press <OK> Then <Next>.

	6. The wizard will found a driver for "Gemplus Readers Loader",
	   then Press <Next>

	7. The required files are copied to your computer and the 
	   device is properly configured.

	8. Press on <Finish> to close the Hardware Wizard.

	9. Another "Add New Hardware Wizard" dialog box show, press <Next>,

	10. Select "Search for the best driver for your device
	   (recommended)" and Press <Next>.

	11. Check the box "Specify a location" and Press <Browse>.

	12. Browse to the same driver file location.  Press <OK>, Then <Next>.

	13. The wizard will found a driver for "Gemplus Serial Smart Card Reader",
	   then Press <Next>

	14. The required files are copied to your computer and the 
	   device is properly configured.

	15. Press on <Finish> to close the Hardware Wizard.

         Now you have to restart the computer for the system to be usable.
         The Microsoft Smart Card Resource Manager is not Plug and Play on
         Windows 98, 98 SE and ME. This is a system limitation. You *must restart* 
	 your system after a reader installation to be able to use 
	 PC/SC system, even if the reader is Plug and Play.


      4.1.3. Check your installation

	1. Check first if all reader component is load and work properly.
	  Right-Click on the "My Computer" icon on the desktop,
	  Choose "properties" and select the "Device Manager" tab:
	  You should get one group for GemplusVirtiualBus and one
	  Group for GemplusSmartCardReader.
	  inside this group all instance of device shouldn't have any
          Yellow bang or Exclamation mark "!" in front.

	2. Check the driver version:
	  Right-Click on the "My Computer" icon on the desktop,
	  Choose "properties" and select the "Device Manager" tab,
	  Select the "SmartCardReader" group,
	  Double-click on "Gemplus Serial Smart Card Reader"
	  Select the "Driver" tab
	  Click on the <Driver File Details> button and check that
	  the driver version matches the version for this file.


	3. Check that the Smart Card service is launched:
   	 Start the registry editor (select "Run..." from the Start
         menu, type "regedit" in the text box, then click OK).
	 Goto 
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunServices]
   	 and check that the SCardSvr Key appears with value
	 "%Windir%\SYSTEM\SCardSvr.exe"


   4.2. Driver update

     We suggest to use the setup program to Update drivers components properly.

	ELSE

      4.2.1. Update

	To update Gemplus Bus driver copy New Grbus.sys to
        previous file system in Windows directory\System32\drivers.


	To update Gemplus reader loader copy new GrLoader.Vxd to
	previous file system in Windows directory\System

	To update Gemplus Serial smartcard reader you have to
        Right-Click on "My Computer" icon on the desktop,
        Choose "Properties" and select the "Device Manager" section,
        Double-click on "SmartcardReader" group,
        Double-click on device component you wish to update.
        Select the "Driver" tab, Then press on <Update Driver> button.

        Press <Next>, on Upgrade Driver Wizard dialog windows,
        Select "Display a list of the known drivers for this device 
        so that I can choose a specific driver", and Press <Next>
        Select <Have Disk...>
        Browse to the driver files location (where you find this
        ReaMe.txt file) and Press <Open>, then <OK>
        Select "Serial Smart card reader", and Press <Next>
        The Wizard is ready to install the driver, Press <Next>.
        Click <Finish> to close the Microsoft Device Driver Wizard.

        The driver is now updated and you can close the 
        "Serial Smart car reader properties" windows and "Computer 
        Management" windows.

        Now you have to restart the computer for the system to be usable.
        The Smart Card Resource Manager is not Plug and Play on
        Windows 98, 98SE and ME. This is a system limitation.  
        You *must restart* your system after a reader installation to be 
        able to use Microsoft PC/SC system, even if the reader is Plug and Play.


      4.2.2. Check your update

         Right-Click on "My Computer" icon on the desktop,
         Choose "Manage" and select the "Device Manager" section,
         Double-click on "SmartcardReader" group,
         Double-click on the new update file
         Select the "Driver" tab property,
	 Check that the "Driver version" matches with update version.


   4.3. Driver removal

      4.3.1. Remove Smartcard Reader First

         Right-Click on "My Computer" icon on the desktop,
         Select "properties" and select the "Device Manager" tab,
         Select the "SmartCardReader" group,
         Select "Gemplus Serial Smart card reader" and
         Press on the <Remove> button.

	 When prompted, confirm the operation by pressing <OK> button.
         When this operation is finished, disconnect the reader.

      4.3.2. Remove Gemplus Virtual Bus driver.

	 To remove Gemplus Virtual bus you have to remove registry keys with RegEdit.exe

         Click on Start and select Run
	 Type regedit.exe.
	 Remove :
         HKEY_LOCAL_MACHINE\Enum\GRBUS
         HKEY_LOCAL_MACHINE\Enum\Root\GemplusVirtualBus
         HKEY_LOCAL_MACHINE\Enum\Serenum\Gem3417

         And now you have to restart the computer to apply these changes.

	Note: this uninstallation does not remove driver files from the system.
	Because reader is a PnP device, if reader is present, the system will lunch corresponding
	drivers. To completely uninstall the reader from the system, remove it's corresponding inf
	files or request device removal from device manager.

      4.3.3. check the removal
         
         After restart,

         Right-Click on "My Computer" icon on the desktop,
         Choose "properties" and select the "Device Manager" tab,
	 Verify that there is no "GemplusVirtualBus".

      4.3.3. Removing Gemplus Virtual Reader from the RM list.

	If Gemplus Serial Reader was removed, there is possibility to remove also Gemplus Virtual Reader 
	from the RM list. It will require to update DWORD registry value:

         HKEY_LOCAL_MACHINE\Enum\Root\GemplusVirtualBus\NumberOfSlots=0.

	As soon as Gemplus Serial Reader will be again installed in the system, the bus driver will automatically
	increment this value and after next reboot the reader will be recognized by the smartcard subsystem.


   4.4 Add More serial smartcard reader

	By default Gemplus Virtual bus supports one Serial smart card reader.
	But, if you need extra  serial smartcard readers,
 	Here is the procedure to follow:

	Click on Start and select Run
	Type regedit.exe.
	browse to: 
        HKEY_LOCAL_MACHINE\Enum\Root\GemplusVirtualBus\0000
	in the rigth windows, right click 
        and select NEW-> DWORD Value
	Type exact word: "NumberOfSlots"   Then Press Enter
	Type in the value data field number of Serial smartcard reader
        you wish to have declare in Smartcard resource manager.

	Restart PC to apply these change.	


   4.5 Change Communication baudrate

	By default at install time the Serial smartcard reader works
	at 115200 baudrate.
	If PC does not support max baudrate, the driver will adjust automatically settings to maximum
	available baudrate.
	If you wish to reduce or fix Serial baudrate used between PC and
        Smartcard reader, you need to add special registry key:

	Click on Start and select Run
	Type regedit.exe.
	browse to: 
        HKEY_LOCAL_MACHINE\Enum\GRBUS\GTWINSER\0
	in the rigth windows, right click 
        and select NEW-> DWORD Value
	Type exact word: "MaxBaudRate"   Then Press Enter
	Type in the value data field the speed limitation you wish reader works.

	Possible value :
	MaxBaudRate = 9600 (in decimal)
	MaxBaudRate = 19200 (in decimal)
	MaxBaudRate = 38400 (in decimal)
	MaxBaudRate = 57600 (in decimal)
	MaxBaudRate = 115200 (in decimal)  Default.

	Restart PC to apply these change.	


5 - User notes (known deviations)
---------------------------------

* The Smart Card Resource Manager is not Plug and Play on Windows
  98, 98SE and Me.  This is a system limitation. 
  You *must reboot* your system after a reader installation to
  be able to use PC/SC.


* After a successful uninstall, if you plug again the device, the system
  keeps traces of previous installation. 
  If you want to remove previous information installation file 
  you have to search in "%WINDIR%\inf\Other" directory.  
  You have to search file name begining by GemplusGrBus.inf,
  GemplusGrLoader.inf and GemplusGTwinSer.inf.

  If you use Setup install program: 
  you have to search also in "%WINDIR%\inf" directory the files that begin
  with oemXX.inf and oemXX.pnf.  Look inside for file contains 
  "Serial Smart Card Reader Driver".


* The serial port was never designed for hot-plugging and device detection.
  So you can plug or unplug a device while the system is running, but there
  is no real hardware support for detection of a device. 

  However, there is software support that implements serial device detection:
  Go to device manager and Press Refresh button to force Pnp Enumaration.

* Unplugging the reader is detected by the smartcard driver that triggers
  a function that closes the connection to the serial driver.

  But the driver will not unload automatically.  To trigger unload of the device,
  in Device Manager, Press Refresh button to unload serial smartcard driver.


6. Troubleshooting
-------------------


If the previously described procedure didn't succeed in installing or
updating the driver, please

1- Open the Device Manager, 
   Click on the "SmartCardReader" group and check
   If a cross appears, or a Yellow bang or exclamation mark "!",
   in front of Gemplus Serial smart card reader.

 
2- Check also if Pnp on you computer detect proprely 
   the smart card reader device Pnp.

   Right-Click on the "My Computer" icon on the desktop,
   Choose "properties" and select the "Device Manager" tab,
   Select the "SmartCardReader" group,
   normally, Serial Smartcard reader appear.

   Else, Press Refresh button to force system to research for
   Serial device presence on com port.

3- Use the Gemplus SmartDiag diagnostics tools to check your settings.
   Generate report and send to Gemplus Hotline region.   



7. Support
----------
In case of problem, please contact Gemplus through the Gemplus web site 
(http://www.gemplus.com/) or depending on your location :

For North America
	email : HOTLINEUSA@gemplus.com
	tel +1 (877) 436-7233

For ASIA
	email : ASIA.hotline@gemplus.com
	No phone line

For other countries
	email : hotline@gemplus.com
	tel +33 (0) 442 36 50 50

----------------------------------------------------------------------
